penPattern
Type
property
Summary
Specifies the pattern used for painting with the paint tool|paint tools.
Syntax
set the penPattern to {<patternNumber> | <imageID> | empty}
Description
Use the penPattern property to change the pattern used with the pencil, line, and curve paint tools, and for the borders of shapes.
Pattern images can be color or black-and-white.
To be used as a pattern on Mac OS systems, an image must be 128x128 pixels or less, and both its height and width must be a power of 2. To be used on Windows and Unix systems, height and width must be divisible by 8. To be used as a fully cross-platform pattern, both an image's dimensions should be one of 8, 16, 32, 64, or 128.
If the penColor has been set since the last time the penPattern was set, the color is used instead of the pattern specified by penPattern. In other words, the last-set property takes priority.
Examples
set the penPattern to empty
set the penPattern to 1013
Value
| Name | Type | Description |
|---|---|---|
value | The penPattern is a pattern specifier. A patternNumber is a built-in pattern number between 1 and 164. These patterns are provided for compatibility with patterns available in MetaCard and correspond to LiveCode's built in image id 137 to 300. As with MetaCard pattern numbers 105 to 114 and 146 and above are unavailable. An imageID is the ID of an image to use for a pattern. LiveCode looks for the specified image first in the current stack, then in other open stacks. By default, the penPattern is empty. |
Related
keyword: image, line, curve, pencil
property: width, height, pixels, foregroundPattern, penColor, brushPattern
command: choose
function: stacks
glossary: property, Windows, paint tool, Mac OS, Unix, current stack
Compatibility and Support
Introduced
LiveCode 1.0
OS
mac
windows
linux
ios
android
Platforms
desktop
server
mobile